package com.ruoyi.note.mapper;

import java.util.List;
import com.ruoyi.note.domain.NoteCategory;

/**
 * 笔记分类Mapper接口
 * 
 * @author ruoyi
 * @date 2025-01-22
 */
public interface NoteCategoryMapper 
{
    /**
     * 查询笔记分类
     * 
     * @param categoryId 笔记分类主键
     * @return 笔记分类
     */
    public NoteCategory selectNoteCategoryByCategoryId(Long categoryId);

    /**
     * 查询笔记分类列表
     * 
     * @param noteCategory 笔记分类
     * @return 笔记分类集合
     */
    public List<NoteCategory> selectNoteCategoryList(NoteCategory noteCategory);

    /**
     * 查询笔记分类树结构
     * 
     * @param noteCategory 笔记分类
     * @return 笔记分类集合
     */
    public List<NoteCategory> selectNoteCategoryTree(NoteCategory noteCategory);

    /**
     * 新增笔记分类
     * 
     * @param noteCategory 笔记分类
     * @return 结果
     */
    public int insertNoteCategory(NoteCategory noteCategory);

    /**
     * 修改笔记分类
     * 
     * @param noteCategory 笔记分类
     * @return 结果
     */
    public int updateNoteCategory(NoteCategory noteCategory);

    /**
     * 删除笔记分类
     * 
     * @param categoryId 笔记分类主键
     * @return 结果
     */
    public int deleteNoteCategoryByCategoryId(Long categoryId);

    /**
     * 批量删除笔记分类
     * 
     * @param categoryIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteNoteCategoryByCategoryIds(Long[] categoryIds);

    /**
     * 查询子分类数量
     * 
     * @param parentId 父分类ID
     * @return 子分类数量
     */
    public int selectChildrenCountByParentId(Long parentId);

    /**
     * 检查分类名称是否唯一
     * 
     * @param categoryName 分类名称
     * @param parentId 父分类ID
     * @param categoryId 分类ID
     * @return 结果
     */
    public NoteCategory checkCategoryNameUnique(String categoryName, Long parentId, Long categoryId);
}